home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmContainer.z / XmContainer
Text File  |  1998-10-30  |  194KB  |  2,575 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr - The Container widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Container.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           Container manages child widgets that have the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm
  19.           trait.  These child widgets can be viewed in several
  20.           different layout formats, selected using different selection
  21.           types and techniques, and directly manipulated by the user.
  22.  
  23.           Three different formats or views are supported by the
  24.           Container.  They are specified via the XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee
  25.           resource:
  26.  
  27.              +o  XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN
  28.  
  29.              +o  XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN
  30.  
  31.              +o  XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN
  32.  
  33.           Three different layout types are supported by the Container.
  34.           They are specified by the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee resource:
  35.  
  36.              +o  XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL
  37.  
  38.              +o  XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE
  39.  
  40.              +o  XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL
  41.  
  42.           In the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL layout type, several other resources
  43.           (XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee, XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllIIIInnnncccclllluuuuddddeeeeMMMMooooddddeeeellll,
  44.           XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSnnnnaaaappppMMMMooooddddeeeellll) control the positioning of the items
  45.           within the Container; an application programmer can specify
  46.           these resources so that the Container strictly enforces the
  47.           position of each item or so that the Container positions
  48.           items according to constraint resources specified for each
  49.           item.  The user, however, can alter the position of an item
  50.           in the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLLlayout type within the Container by direct
  51.           manipulation; for example, by pressing BBBBTTTTrrrraaaannnnssssffffeeeerrrr over the
  52.           item and then dragging and releasing BBBBTTTTrrrraaaannnnssssffffeeeerrrrover some
  53.           location within the Container.
  54.  
  55.           In the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type, the Container controls the
  56.           positioning of the items. Items within the Container can
  57.           have parent-child relationships between them. Each item's
  58.           XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt resource can specify another item in the same
  59.           Container as its parent; items with a non-NULL value for
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt can only be displayed in the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout
  75.           type. In the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type, items are positioned in
  76.           a tree configuration with connecting lines drawn to
  77.           illustrate the relationships.  Items are positioned top to
  78.           bottom in the order specified by XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within
  79.           their parent.  Container positions a PushButton next to each
  80.           item that has a parent relationship to other items. The
  81.           PushButton contains a pixmap to illustrate whether the child
  82.           items are shown or not; the user can activate the PushButton
  83.           to toggle between showing or hiding the child items.  Direct
  84.           manipulation to alter the position of the item is not
  85.           supported in the XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout type.  Note that the
  86.           XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn resource of the PushButtons created by
  87.           Container are set to False.
  88.  
  89.           The XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout type is the same as XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE, except
  90.           that each item can also display additional information as
  91.           rows in columns with column headers specified in the
  92.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnnggggresources. In each item row, the
  93.           item's detail information (see the reference page on
  94.           XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt for a description of the _X_m_N_e_n_t_r_y_D_e_t_a_i_l
  95.           resource) is displayed. Items are positioned top to bottom
  96.           in the order specified by XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within the
  97.           parent.
  98.  
  99.         SSSSeeeelllleeeeccccttttiiiioooonnnn
  100.           When a child widget of the container is selected, the
  101.           container specifies that the item should display the
  102.           appropriate visual information to the user via the
  103.           CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait.  The application program is notified of
  104.           selection changes through XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk.
  105.  
  106.           The container uses four selection policies:
  107.  
  108.              +o  Single
  109.  
  110.              +o  Browse
  111.  
  112.              +o  Multiple
  113.  
  114.              +o  Extended
  115.  
  116.           In Single Select and Browse Select modes, only one item can
  117.           be selected at a time. Pressing BBBBSSSSeeeelllleeeecccctttton an item selects it
  118.           and deselects any other selected item.  Pressing BBBBSSSSeeeelllleeeecccctttt
  119.           over an empty space in the Container deselects all items. In
  120.           Browse Select, dragging BBBBSSSSeeeelllleeeecccctttt moves the selection as the
  121.           pointer is moved.
  122.  
  123.           In Multiple Select and Extended Select modes, any number of
  124.           items can be selected at the same time.  In Multiple Select,
  125.           pressing and dragging BBBBSSSSeeeelllleeeecccctttt or BBBBEEEExxxxtttteeeennnndddd to specify an item,
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           range of items, or group of discontiguous items causes the
  141.           selection states of those items to be toggled. In Extended
  142.           Select, pressing and dragging BBBBSSSSeeeelllleeeecccctttt to indicate an item,
  143.           range of items, or group of discontiguous items selects
  144.           those items and deselects all others. Pressing and dragging
  145.           BBBBEEEExxxxtttteeeennnndddd in Extended Select to indicate an item, range of
  146.           items, or discontiguous group of items causes the selection
  147.           states of those items to be toggled.
  148.  
  149.           Several techniques are available to indicate an item, range
  150.           of items, or group of discontiguous items in the Multiple
  151.           Select and Extended Select modes.
  152.  
  153.           In the XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE layout types, the
  154.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee resource specifies the techniques to
  155.           be used to indicate items. The default specification of
  156.           XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRRallows both the Random-Swipe and Marquee
  157.           techniques to be used when _X_m_N_l_a_y_o_u_t_S_t_y_l_e is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. The
  158.           default specification of XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRR allows the Range-
  159.           Swipe, Range-Click, and Marquee techniques to be used when
  160.           _X_m_N_l_a_y_o_u_t_S_t_y_l_e is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE.
  161.  
  162.           Discontiguous groups of items can be selected using the
  163.           Random-Swipe technique.  In the Random-Swipe technique,
  164.           pressing BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over an item and dragging
  165.           BBBBSSSSeeeelllleeeecccctttt over other items selects all of those items. Only
  166.           those items that pointer passed over are selected.
  167.  
  168.           In the Range-Swipe technique, the user presses BBBBSSSSeeeelllleeeecccctttt (or
  169.           BBBBEEEExxxxtttteeeennnndddd) over the first item and releases BBBBSSSSeeeelllleeeecccctttt over the
  170.           last item; all items within the range between the first and
  171.           last item are selected whether the pointer actually passed
  172.           over them or not.  In the Range-Click technique, the user
  173.           presses and releases BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over the first
  174.           item and then presses and releases BBBBEEEExxxxtttteeeennnndddd over the last
  175.           item.
  176.  
  177.           In the Marquee technique, pressing BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) over
  178.           a blank space within the Container indicates the starting
  179.           point of a Marquee rectangle. Dragging BBBBSSSSeeeelllleeeecccctttt draws a
  180.           Marquee rectangle (rubberband line) between the starting
  181.           point and current pointer. All items completely within the
  182.           Marquee rectangle are selected.
  183.  
  184.           Specifying XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY for XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee enforces
  185.           the Random-Swipe technique even when BBBBSSSSeeeelllleeeecccctttt (or BBBBEEEExxxxtttteeeennnndddd) is
  186.           pressed over a blank space.  Similarly, specifying XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE
  187.           enforces the Marquee technique even when BBBBSSSSeeeelllleeeecccctttt (or
  188.           BBBBEEEExxxxtttteeeennnndddd) is pressed over an item; since the item over which
  189.           the press occurs is only partially included in the Marquee
  190.           rectangle, it is not selected.  XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT and
  191.           XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH enforce the Marquee technique and also
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  203.  
  204.  
  205.  
  206.           cause the rectangle to extend automatically around the first
  207.           item indicated and, for XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH, the last
  208.           item.
  209.  
  210.           In the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout type, the Range-Swipe and Range-Click
  211.           techniques are available to indicate a range of items for
  212.           selection.
  213.  
  214.           Container uses the _X_m_Q_T_c_o_n_t_a_i_n_e_r_I_t_e_m, _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e, and
  215.           _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_etraits and holds the XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrr and
  216.           _X_m_Q_T_t_r_a_n_s_f_e_r traits.
  217.  
  218.         DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
  219.           Container supports dragging of selected items from the
  220.           widget.  Depending on the value of XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp,
  221.           Container can also support primary selection.
  222.  
  223.           As a source of data, Container supports the following
  224.           targets and associated conversions of data to these targets:
  225.  
  226.           _l_o_c_a_l_e    If the _l_o_c_a_l_e target matches the widget's locale,
  227.                     the widget transfers the selected items in the
  228.                     encoding of the locale.  The value for each item
  229.                     transferred, except the last, includes a trailing
  230.                     separator.  Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  231.                     of the item.
  232.  
  233.           _C_O_M_P_O_U_N_D__T_E_X_T
  234.                     The widget transfers the selected items as type
  235.                     _C_O_M_P_O_U_N_D__T_E_X_T.  The value for each item
  236.                     transferred, except the last, includes a trailing
  237.                     separator.  Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  238.                     of the item.
  239.  
  240.           _D_E_L_E_T_E    The widget deletes the selected items.
  241.  
  242.           _P_I_X_M_A_P    The widget transfers a list of the pixmap IDs of
  243.                     the selected items as type _D_R_A_W_A_B_L_E.
  244.  
  245.           _S_T_R_I_N_G    The widget transfers the selected items as type
  246.                     _S_T_R_I_N_G.  The value for each item transferred,
  247.                     except the last, includes a trailing separator.
  248.                     Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item.
  249.  
  250.           _T_E_X_T      If the selected items are fully convertible to the
  251.                     encoding of the locale, the widget transfers the
  252.                     selected items in the encoding of the locale.
  253.                     Otherwise, the widget transfers the selected items
  254.                     as type _C_O_M_P_O_U_N_D__T_E_X_T.  The value for each item
  255.                     transferred, except the last, includes a trailing
  256.                     separator.  Each item value is the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  257.                     of the item.
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  269.  
  270.  
  271.  
  272.           ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
  273.                     The widget transfers, as type _A_T_O_M, a list of the
  274.                     targets it supports for immediate transfer for the
  275.                     _C_L_I_P_B_O_A_R_D selection.  These include
  276.                     ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG and _P_I_X_M_A_P.  If the
  277.                     selected items are fully convertible to _S_T_R_I_N_G,
  278.                     these also include _S_T_R_I_N_G; otherwise, they also
  279.                     include _C_O_M_P_O_U_N_D__T_E_X_T.
  280.  
  281.           ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG
  282.                     The widget transfers the selected items as a
  283.                     compound string in Byte Stream format.  The value
  284.                     for each item transferred, except the last,
  285.                     includes a trailing separator.  Each item value is
  286.                     the XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg of the item.
  287.  
  288.           ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
  289.                     The widget transfers, as type _A_T_O_M, a list of the
  290.                     targets it supports for delayed transfer for the
  291.                     _C_L_I_P_B_O_A_R_D selection.  This widget currently
  292.                     supplies no targets for
  293.                     ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS.
  294.  
  295.           ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRRAAAAGGGG____OOOOFFFFFFFFSSSSEEEETTTT
  296.                     The widget transfers a list of two 16-bit numbers,
  297.                     of type _I_N_T_E_G_E_R, representing an x and y offset
  298.                     for an item being dragged.  This offset is
  299.                     calculated so that, if the offset were added to
  300.                     the x and y coordinates at the drop site, and the
  301.                     dragged pixmap placed at that position, it would
  302.                     correspond to the position the user would expect
  303.                     the pixmap to placed at, based on the drag icon
  304.                     used at the drop site.
  305.  
  306.           ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
  307.                     The widget transfers, as type _A_T_O_M, a list of the
  308.                     targets to be used as the value of the
  309.                     DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
  310.                     transfer.  These include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG,
  311.                     _P_I_X_M_A_P, _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale,
  312.                     _S_T_R_I_N_G, _T_E_X_T, _B_A_C_K_G_R_O_U_N_D, and _F_O_R_E_G_R_O_U_N_D.
  313.  
  314.           As a source of data, Container also supports the following
  315.           standard Motif targets:
  316.  
  317.           _B_A_C_K_G_R_O_U_N_D
  318.                     The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L.
  319.  
  320.           _C_L_A_S_S     The widget finds the first shell in the widget
  321.                     hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
  322.                     transfers the contents as text in the current
  323.                     locale.
  324.  
  325.  
  326.  
  327.      Page 5                                         (printed 10/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           _C_L_I_E_N_T__W_I_N_D_O_W
  339.                     The widget finds the first shell in the widget
  340.                     hierarchy and transfers its window as type _W_I_N_D_O_W.
  341.  
  342.           _C_O_L_O_R_M_A_P  The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P.
  343.  
  344.           _F_O_R_E_G_R_O_U_N_D
  345.                     The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L.
  346.  
  347.           _N_A_M_E      The widget finds the first shell in the widget
  348.                     hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
  349.                     transfers the contents as text in the current
  350.                     locale.
  351.  
  352.           _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
  353.                     targets it supports.  These include the standard
  354.                     targets in this list.  These also include
  355.                     ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _P_I_X_M_A_P, _C_O_M_P_O_U_N_D__T_E_X_T, the
  356.                     encoding of the locale, _S_T_R_I_N_G, and _T_E_X_T.
  357.  
  358.           _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
  359.                     the selection as type _I_N_T_E_G_E_R.
  360.  
  361.           ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
  362.                     The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
  363.                     or else the default text render table, as type
  364.                     _S_T_R_I_N_G.
  365.  
  366.           ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
  367.                     The widget transfers its encoding registry as type
  368.                     _S_T_R_I_N_G.  The value is a list of NULL separated
  369.                     items in the form of tag encoding pairs.  This
  370.                     target symbolizes the transfer target for the
  371.                     Motif Segment Encoding Registry.  Widgets and
  372.                     applications can use this Registry to register
  373.                     text encoding formats for specified render table
  374.                     tags.  Applications access this Registry by
  375.                     calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
  376.                     XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.
  377.  
  378.           As a destination for data, Container supports only the
  379.           dropping of items being dragged from the same widget.
  380.           Subclasses and the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are
  381.           responsible for any other data transfers to the widget.
  382.  
  383.         CCCCllllaaaasssssssseeeessss
  384.           Container inherits behavior, resources, and traits from the
  385.           CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes.
  386.  
  387.           The class pointer is _x_m_C_o_n_t_a_i_n_e_r_W_i_d_g_e_t_C_l_a_s_s.
  388.  
  389.           The class name is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr.
  390.  
  391.  
  392.  
  393.      Page 6                                         (printed 10/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  401.  
  402.  
  403.  
  404.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  405.           The following table defines a set of widget resources used
  406.           by the programmer to specify data. The programmer can also
  407.           set the resource values for the inherited classes to set
  408.           attributes for this widget.  To reference a resource by name
  409.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  410.           prefix and use the remaining letters.  To specify one of the
  411.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssssfile, remove
  412.           the XXXXmmmm prefix and use the remaining letters (in either
  413.           lowercase or uppercase, but include any underscores between
  414.           words). The codes in the access column indicate whether the
  415.           given resource can be set at creation time (C), set by using
  416.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  417.           not applicable (N/A).
  418.  
  419.                                                      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  420.           NNNNaaaammmmeeee                          CCCCllllaaaassssssss                         TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                    AAAAcccccccceeeessssssss
  421.           XmNautomaticSelection         XmCAutomaticSelection         unsigned char    XmAUTO_SELECT              CSG
  422.           XmNcollapsedStatePixmap       XmCCollapsedStatePixmap       Pixmap           dynamic                    CSG
  423.           XmNconvertCallback            XmCCallback                   XtCallbackList   NULL                       C
  424.           XmNdefaultActionCallback      XmCCallback                   XtCallbackList   NULL                       C
  425.           XmNdestinationCallback        XmCCallback                   XtCallbackList   NULL                       C
  426.           XmNdetailColumnHeading        XmCDetailColumnHeading        XmStringTable    NULL                       CSG
  427.           XmNdetailColumnHeadingCount   XmCDetailColumnHeadingCount   Cardinal         0                          CSG
  428.           XmNdetailOrder                XmCDetailOrder                Cardinal *       NULL                       CSG
  429.           XmNdetailOrderCount           XmCDetailOrderCount           Cardinal         dynamic                    CSG
  430.           XmNdetailTabList              XmCDetailTabList              XmTabList        NULL                       CSG
  431.           XmNentryViewType              XmCEntryViewType              unsigned char    XmANY_ICON                 CSG
  432.           XmNexpandedStatePixmap        XmCExpandedStatePixmap        Pixmap           dynamic                    CSG
  433.           XmNfontList                   XmCFontList                   XmFontList       NULL                       CSG
  434.           XmNlargeCellHeight            XmCCellHeight                 Dimension        dynamic                    CSG
  435.           XmNlargeCellWidth             XmCCellWidth                  Dimension        dynamic                    CSG
  436.           XmNlayoutType                 XmCLayoutType                 unsigned char    XmSPATIAL                  CSG
  437.           XmNmarginHeight               XmCMarginHeight               Dimension        0                          CSG
  438.           XmNmarginWidth                XmCMarginWidth                Dimension        0                          CSG
  439.           XmNoutlineButtonPolicy        XmCOutlineButtonPolicy        unsigned char    XmOUTLINE_BUTTON_PRESENT   CSG
  440.           XmNoutlineChangedCallback     XmCCallback                   XtCallbackList   NULL                       C
  441.           XmNoutlineColumnWidth         XmCOutlineColumnWidth         Dimension        dynamic                    CSG
  442.           XmNoutlineIndentation         XmCOutlineIndentation         Dimension        40                         CSG
  443.           XmNoutlineLineStyle           XmCLineStyle                  unsigned char    XmSINGLE                   CSG
  444.           XmNprimaryOwnership           XmCprimaryOwnership           unsigned char    XmOWN_POSSIBLE_MULTIPLE    CSG
  445.           XmNrenderTable                XmCRenderTable                XmRenderTable    dynamic                    CSG
  446.           XmNselectColor                XmCSelectColor                Pixel            dynamic                    CSG
  447.           XmNselectedObjects            XmCSelectedObjects            WidgetList       NULL                       SG
  448.           XmNselectedObjectCount        XmCSelectedObjectCount        unsigned int     0                          SG
  449.           XmNselectionCallback          XmCCallback                   XtCallbackList   NULL                       C
  450.           XmNselectionPolicy            XmCSelectionPolicy            unsigned char    XmEXTENDED_SELECT          CSG
  451.           XmNselectionTechnique         XmCSelectionTechnique         unsigned char    XmTOUCH_OVER               CSG
  452.           XmNsmallCellHeight            XmCCellHeight                 Dimension        dynamic                    CSG
  453.           XmNsmallCellWidth             XmCCellWidth                  Dimension        dynamic                    CSG
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                         (printed 10/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           XmNspatialIncludeModel        XmCSpatialIncludeModel        unsigned char    XmAPPEND                   CSG
  471.           XmNspatialResizeModel         XmCSpatialResizeModel         unsigned char    XmGROW_MINOR               CSG
  472.           XmNspatialSnapModel           XmCSpatialSnapModel           unsigned char    XmNONE                     CSG
  473.           XmNspatialStyle               XmCSpatialStyle               unsigned char    XmGRID                     CSG
  474.  
  475.           XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn
  476.                     Indicates whether the Container invokes selection
  477.                     callbacks when each item is selected (or toggled)
  478.                     or whether selection callbacks are not invoked
  479.                     until the user has completed selection actions
  480.                     (for example, the user has released the mouse
  481.                     button). It can have one of the following values:
  482.  
  483.                     XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  484.                               Makes selection callbacks automatically
  485.                               when each item is selected or toggled.
  486.                               This may also be the value TTTTRRRRUUUUEEEE.
  487.  
  488.                     XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  489.                               Delays selection callbacks until the
  490.                               user has finished selection actions.
  491.                               This may also be the value FFFFAAAALLLLSSSSEEEE.
  492.  
  493.           XXXXmmmmNNNNccccoooollllllllaaaappppsssseeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp
  494.                     Specifies the pixmap to display on a PushButton
  495.                     next to a Container item with child items, when
  496.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy is
  497.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT.  XXXXmmmmNNNNccccoooollllllllaaaappppsssseeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp
  498.                     indicates that the child items are not displayed.
  499.                     If set to XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, a default pixmap
  500.                     showing an arrow pointing up is used.
  501.  
  502.           XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
  503.                     Specifies a list of callbacks called when the
  504.                     Container is asked to convert a selection.  The
  505.                     type of the structure whose address is passed to
  506.                     these callbacks is XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
  507.                     reason is XXXXmmmmCCCCRRRR____OOOOKKKK.
  508.  
  509.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
  510.                     Specifies a list of callbacks to call when the
  511.                     user double-clicks an item or presses <<<<EEEEnnnntttteeeerrrr>>>> or
  512.                     <<<<RRRReeeettttuuuurrrrnnnn>>>> over an item.  The callback structure is
  513.                     XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSeeeelllleeeeccccttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason is
  514.                     XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN.
  515.  
  516.           XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
  517.                     Specifies a list of callbacks called when the
  518.                     Container is the destination of a transfer
  519.                     operation.  The type of the structure whose
  520.                     address is passed to these callbacks is
  521.                     XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason is
  522.  
  523.  
  524.  
  525.      Page 8                                         (printed 10/24/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     XXXXmmmmCCCCRRRR____OOOOKKKK.
  537.  
  538.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnngggg
  539.                     Specifies a table of XXXXmmmmSSSSttttrrrriiiinnnnggggs to display as the
  540.                     headings to columns.  If NULL, or if
  541.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, no heading is
  542.                     displayed.
  543.  
  544.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnnggggCCCCoooouuuunnnntttt
  545.                     Specifies a count of XXXXmmmmSSSSttttrrrriiiinnnnggggs in the table
  546.                     specified for XXXXmmmmNNNNddddeeeettttaaaaiiiillllCCCCoooolllluuuummmmnnnnHHHHeeeeaaaaddddiiiinnnngggg.
  547.  
  548.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr
  549.                     Specifies an array of CCCCaaaarrrrddddiiiinnnnaaaalllls that indicate
  550.                     which column detail information, and in which
  551.                     order, each Container child will display its
  552.                     detail information.  This resource is ignored if
  553.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.  If NULL, the the
  554.                     default behavior is determined by
  555.                     XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt.
  556.  
  557.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt
  558.                     Specifies a count of CCCCaaaarrrrddddiiiinnnnaaaalllls in the array
  559.                     specified for XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr.  If XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrr
  560.                     is NULL and XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt is not 0, then
  561.                     each Container child displays its detail
  562.                     information in order from column 1 to the
  563.                     XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnntttt column number. If
  564.                     XXXXmmmmNNNNddddeeeettttaaaaiiiillllOOOOrrrrddddeeeerrrrCCCCoooouuuunnnnttttis 0, then a default is
  565.                     calculated from the detail order count information
  566.                     of each item accessed via the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait.
  567.  
  568.           XXXXmmmmNNNNddddeeeettttaaaaiiiillllTTTTaaaabbbbLLLLiiiisssstttt
  569.                     Indicates an XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt specifying the start of
  570.                     each column in the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout.  If this
  571.                     resource is set to NULL, then Container calculates
  572.                     an XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt.  This resource is ignored if
  573.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is not XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.
  574.  
  575.           XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee
  576.                     Specifies the view type for all Container
  577.                     children. The view type is specified for each item
  578.                     via the CCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm trait.  It can have one of
  579.                     the following values:
  580.  
  581.                     XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN
  582.                               No specification is made for Container
  583.                               children. Children use their own default
  584.                               specifications.
  585.  
  586.                     XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN
  587.                               The view type for all children is
  588.  
  589.  
  590.  
  591.      Page 9                                         (printed 10/24/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  599.  
  600.  
  601.  
  602.                               XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN.
  603.  
  604.                     XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN
  605.                               The view type for all children is
  606.                               XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN.
  607.  
  608.           XXXXmmmmNNNNeeeexxxxppppaaaannnnddddeeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp
  609.                     Specifies the pixmap to display on a PushButton
  610.                     next to a Container item with child items, when
  611.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy is
  612.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT.  XXXXmmmmNNNNeeeexxxxppppaaaannnnddddeeeeddddSSSSttttaaaatttteeeePPPPiiiixxxxmmmmaaaapppp
  613.                     indicates that the child items are displayed.  If
  614.                     set to XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, a default pixmap
  615.                     showing an arrow pointing down is used.
  616.  
  617.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  618.                     Specifies the fontlist associated with
  619.                     XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr. The fontlist is an obsolete construct
  620.                     and has been superseded by the render table.  It
  621.                     is included for compatibility with earlier
  622.                     versions of Motif, and for applications that do
  623.                     not easily support render tables. The default
  624.                     fontlist is derived from the default render table;
  625.                     and if both a fontlist and a render table are
  626.                     specified, the render table takes precedence.
  627.  
  628.           XXXXmmmmNNNNllllaaaarrrrggggeeeeCCCCeeeellllllllHHHHeeeeiiiigggghhhhtttt
  629.                     Specifies the height of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or
  630.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is
  631.                     XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN.
  632.  
  633.           XXXXmmmmNNNNllllaaaarrrrggggeeeeCCCCeeeellllllllWWWWiiiiddddtttthhhh
  634.                     Specifies the width of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or
  635.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is
  636.                     XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmAAAANNNNYYYY____IIIICCCCOOOONNNN.
  637.  
  638.           XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee
  639.                     Specifies the policy for laying out child widgets
  640.                     within the Container.  It can have one of the
  641.                     following values:
  642.  
  643.                     XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL  Displays items in the same manner as
  644.                               when the resource is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE, except
  645.                               that each item displays detail
  646.                               information next to it.
  647.  
  648.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE Displays items in a tree configuration,
  649.                               in XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx within
  650.                               XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt order, with connecting
  651.                               lines drawn to show their parent-child
  652.                               relationships.
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                        (printed 10/24/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL Displays items according to
  669.                               XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee.  Items with
  670.                               XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt values are not displayed.
  671.  
  672.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  673.                     Specifies the margin spacing at the top and bottom
  674.                     of the Container.
  675.  
  676.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  677.                     Specifies the margin spacing at the left and right
  678.                     sides of the Container.
  679.  
  680.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeBBBBuuuuttttttttoooonnnnPPPPoooolllliiiiccccyyyy
  681.                     Specifies whether or not to display buttons for
  682.                     users to expand and collapse the display of items.
  683.                     It can have one of the following values:
  684.  
  685.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____AAAABBBBSSSSEEEENNNNTTTT
  686.                               Do not display the outline buttons.
  687.  
  688.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE____BBBBUUUUTTTTTTTTOOOONNNN____PPPPRRRREEEESSSSEEEENNNNTTTT
  689.                               Display the outline buttons.
  690.  
  691.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  692.                     Specifies a list of callbacks to call when an
  693.                     item's XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeeeis changed.  The callback
  694.                     structure is XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrOOOOuuuuttttlllliiiinnnneeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
  695.                     The reason is XXXXmmmmCCCCRRRR____CCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD or XXXXmmmmCCCCRRRR____EEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD,
  696.                     depending on the new value of XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee.
  697.  
  698.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCCoooolllluuuummmmnnnnWWWWiiiiddddtttthhhh
  699.                     Specifies the width of the first column displayed
  700.                     when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL. Specifies the
  701.                     preferred width of the Container (without the
  702.                     margins) when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE.  If not
  703.                     specified, Container will determine a default
  704.                     value equal to the widest space necessary to
  705.                     display an item's pixmap and
  706.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeIIIInnnnddddeeeennnnttttaaaattttiiiioooonnnn.
  707.  
  708.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeIIIInnnnddddeeeennnnttttaaaattttiiiioooonnnn
  709.                     Specifies the distance to indent for the display
  710.                     of child items when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or
  711.                     XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.
  712.  
  713.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeLLLLiiiinnnneeeeSSSSttttyyyylllleeee
  714.                     Specifies whether to draw lines between items with
  715.                     parent-child relationships when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis
  716.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.  It can have one of the
  717.                     following values:
  718.  
  719.                     XXXXmmmmNNNNOOOO____LLLLIIIINNNNEEEE Draws no line.
  720.  
  721.  
  722.  
  723.      Page 11                                        (printed 10/24/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  731.  
  732.  
  733.  
  734.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE  Draws a line one pixel wide.
  735.  
  736.           XXXXmmmmNNNNpppprrrriiiimmmmaaaarrrryyyyOOOOwwwwnnnneeeerrrrsssshhhhiiiipppp
  737.                     Specifies whether Container takes ownership of the
  738.                     primary selection when a selection is made inside
  739.                     it. This resource can take the following values:
  740.  
  741.                     XXXXmmmmOOOOWWWWNNNN____NNNNEEEEVVVVEEEERRRR
  742.                               Never takes ownership.
  743.  
  744.                     XXXXmmmmOOOOWWWWNNNN____AAAALLLLWWWWAAAAYYYYSSSS
  745.                               Always takes ownership.
  746.  
  747.                     XXXXmmmmOOOOWWWWNNNN____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE
  748.                               Only takes ownership if more than one
  749.                               element has been selected.
  750.  
  751.                     XXXXmmmmOOOOWWWWNNNN____PPPPOOOOSSSSSSSSIIIIBBBBLLLLEEEE____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE
  752.                               Only takes ownership if more than one
  753.                               element can be selected at a time.
  754.  
  755.           XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
  756.                     Specifies the XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee that is inherited by
  757.                     all children of the Container.  The default is
  758.                     implementation dependent.  If both a render table
  759.                     and a fontlist are specified, the render table
  760.                     will take precedence.
  761.  
  762.           XXXXmmmmNNNNsssseeeelllleeeeccccttttCCCCoooolllloooorrrr
  763.                     Specifies a Pixel that can be accessed by children
  764.                     of the Container and used to indicate that the
  765.                     child is in a selected state. In addition to a
  766.                     Pixel value, the following symbolic values can be
  767.                     specified:
  768.  
  769.                     XXXXmmmmDDDDEEEEFFFFAAAAUUUULLLLTTTT____SSSSEEEELLLLEEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR
  770.                               Specifies a color between the background
  771.                               and the bottom shadow color.
  772.  
  773.                     XXXXmmmmRRRREEEEVVVVEEEERRRRSSSSEEEEDDDD____GGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRRSSSS
  774.                               Forces the select color to the
  775.                               foreground color and causes the default
  776.                               color of any text rendered over the
  777.                               select color to be the background color.
  778.  
  779.                     _H_I_G_H_L_I_G_H_T__C_O_L_O_R
  780.                               Forces the fill color to use the
  781.                               highlight color.
  782.  
  783.           XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttCCCCoooouuuunnnntttt
  784.                     Specifies the number of widgets in the selected
  785.                     items list.  The value must be the number of items
  786.  
  787.  
  788.  
  789.      Page 12                                        (printed 10/24/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  797.  
  798.  
  799.  
  800.                     in XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss.
  801.  
  802.           XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss
  803.                     An array of widgets that represents the Container
  804.                     items that are currently selected, either by the
  805.                     user or by the application.
  806.  
  807.                     If the application sets XXXXmmmmNNNNsssseeeelllleeeecccctttteeeeddddOOOObbbbjjjjeeeeccccttttssss to an
  808.                     array of widgets, those array elements that are
  809.                     valid Container items are selected.
  810.  
  811.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
  812.                     Specifies a list of callbacks to call when an item
  813.                     is selected.  The callback structure is
  814.                     XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSeeeelllleeeeccccttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason is
  815.                     XXXXmmmmCCCCRRRR____SSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT,
  816.                     XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, or XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE,
  817.                     depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  818.  
  819.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy
  820.                     Defines the interpretation of the selection
  821.                     action. This can be one of the following values:
  822.  
  823.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  824.                               Allows only single selections.
  825.  
  826.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  827.                               Allows "drag and browse" selections.
  828.  
  829.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  830.                               Allows multiple selections.
  831.  
  832.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  833.                               Allows extended selections.
  834.  
  835.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee
  836.                     Specifies the selection technique to use when the
  837.                     Container displays items in a 2-dimensional layout
  838.                     (XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or
  839.                     XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN).  In the XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL layout, the
  840.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeeeresource is treated as
  841.                     XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY. In either case, it can have one of
  842.                     the following values:
  843.  
  844.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE Uses the Marquee technique only.
  845.  
  846.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT
  847.                               Uses the Marquee technique only and
  848.                               extends the Marquee rectangle around any
  849.                               item under the Marquee start point.
  850.  
  851.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH
  852.  
  853.  
  854.  
  855.      Page 13                                        (printed 10/24/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                               Uses the Marquee technique only and
  867.                               extends the Marquee rectangle around any
  868.                               items under the Marquee start and end
  869.                               points.
  870.  
  871.                     XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOONNNNLLLLYYYY
  872.                               Uses the Random-Swipe technique only if
  873.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL.  Otherwise,
  874.                               uses the Range-Swipe and Range-Click
  875.                               techniques.
  876.  
  877.                     XXXXmmmmTTTTOOOOUUUUCCCCHHHH____OOOOVVVVEEEERRRR
  878.                               If the selection action begins over an
  879.                               item and XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL,
  880.                               uses the Random-Swipe technique.  If the
  881.                               selection action begins over an item and
  882.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL,
  883.                               uses the Range-Swipe and Range-Click
  884.                               techniques.  Uses the Marquee technique
  885.                               if the select action begins over an
  886.                               unoccupied area in the Container.
  887.  
  888.           XXXXmmmmNNNNssssmmmmaaaallllllllCCCCeeeellllllllHHHHeeeeiiiigggghhhhtttt
  889.                     Specifies the height of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or
  890.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is
  891.                     XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN.
  892.  
  893.           XXXXmmmmNNNNssssmmmmaaaallllllllCCCCeeeellllllllWWWWiiiiddddtttthhhh
  894.                     Specifies the width of a cell for XXXXmmmmGGGGRRRRIIIIDDDD or
  895.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS spatial style when XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee is
  896.                     XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN.
  897.  
  898.           XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllIIIInnnncccclllluuuuddddeeeeMMMMooooddddeeeellll
  899.                     Specifies the layout of an item when the item is
  900.                     managed in the Container when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is
  901.                     XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or
  902.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS.  It can have one of the following values:
  903.  
  904.                     XXXXmmmmAAAAPPPPPPPPEEEENNNNDDDD  Places the item after the last occupied
  905.                               cell according to XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  906.  
  907.                     XXXXmmmmCCCCLLLLOOOOSSSSEEEESSSSTTTT Places the item in the free cell closest
  908.                               to the position specified by XXXXmmmmNNNNxxxx and
  909.                               XXXXmmmmNNNNyyyy.
  910.  
  911.                     XXXXmmmmFFFFIIIIRRRRSSSSTTTT____FFFFIIIITTTT
  912.                               Places the item in the first free cell
  913.                               according to XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  914.  
  915.           XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllRRRReeeessssiiiizzzzeeeeMMMMooooddddeeeellll
  916.                     Specifies how Container will attempt to grow its
  917.                     dimensions when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and
  918.  
  919.  
  920.  
  921.      Page 14                                        (printed 10/24/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  929.  
  930.  
  931.  
  932.                     XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or XXXXmmmmCCCCEEEELLLLLLLLSSSSand there are
  933.                     not enough cells to contain a new Container item.
  934.                     It can have one of the following values:
  935.  
  936.                     XXXXmmmmGGGGRRRROOOOWWWW____BBBBAAAALLLLAAAANNNNCCCCEEEEDDDD
  937.                               Container will request both width and
  938.                               height growth from its parent.
  939.  
  940.                     XXXXmmmmGGGGRRRROOOOWWWW____MMMMAAAAJJJJOOOORRRR
  941.                               Container will request growth in its
  942.                               major dimension from its parent.
  943.                               Container's major dimension is width
  944.                               when the precedence of
  945.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is horizontal, and
  946.                               height when vertical.
  947.  
  948.                     XXXXmmmmGGGGRRRROOOOWWWW____MMMMIIIINNNNOOOORRRR
  949.                               Container will request growth in its
  950.                               minor dimension from its parent.
  951.                               Container's minor dimension is height
  952.                               when the precedence of
  953.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is horizontal, and
  954.                               width when vertical.
  955.  
  956.           XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSnnnnaaaappppMMMMooooddddeeeellll
  957.                     Specifies how Container will position an item
  958.                     within the cell layout when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is
  959.                     XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL and XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee is XXXXmmmmGGGGRRRRIIIIDDDD or
  960.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS.  It can have one of the following values:
  961.  
  962.                     XXXXmmmmCCCCEEEENNNNTTTTEEEERRRR  Center the items as follows, depending
  963.                               on the value of XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVViiiieeeewwwwTTTTyyyyppppeeee:
  964.  
  965.                               XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN
  966.                                         The child is centered in the
  967.                                         cell horizontally and
  968.                                         baseline-aligned vertically.
  969.  
  970.                               XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN
  971.                                         The child is centered in the
  972.                                         cell vertically on its
  973.                                         baseline and aligned with the
  974.                                         left or right of the cell
  975.                                         horizontally, depending on the
  976.                                         value of XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  977.  
  978.                     XXXXmmmmSSSSNNNNAAAAPPPP____TTTTOOOO____GGGGRRRRIIIIDDDD
  979.                               Position the item at the upper-left or
  980.                               upper-right corner of the cell(s),
  981.                               depending on the value of
  982.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  983.  
  984.  
  985.  
  986.  
  987.      Page 15                                        (printed 10/24/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  995.  
  996.  
  997.  
  998.                     XXXXmmmmNNNNOOOONNNNEEEE    Position the item according to the
  999.                               position specified by XXXXmmmmNNNNxxxx and XXXXmmmmNNNNyyyy.  If
  1000.                               the position is not within the
  1001.                               coordinates of the cell(s), then
  1002.                               position the item at the upper-left or
  1003.                               upper-right corner of the cell(s),
  1004.                               depending on the value of
  1005.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  1006.  
  1007.           XXXXmmmmNNNNssssppppaaaattttiiiiaaaallllSSSSttttyyyylllleeee
  1008.                     Specifies the layout of Container items when
  1009.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL. It can have one of the
  1010.                     following values:
  1011.  
  1012.                     XXXXmmmmCCCCEEEELLLLLLLLSSSS   Lays out items within a grid of same-
  1013.                               size cells.  Each item occupies as many
  1014.                               cells as required to contain the item
  1015.                               dimensions.
  1016.  
  1017.                     XXXXmmmmGGGGRRRRIIIIDDDD    Lays out items within a grid of same-
  1018.                               size cells.  Each item occupies only one
  1019.                               cell. Items that are larger than the
  1020.                               cell size may overlap other items.
  1021.  
  1022.                     XXXXmmmmNNNNOOOONNNNEEEE    Lays out items according to XXXXmmmmNNNNxxxx and
  1023.                               XXXXmmmmNNNNyyyy.
  1024.  
  1025.                              XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  1026.           NNNNaaaammmmeeee               CCCCllllaaaassssssss              TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt       AAAAcccccccceeeessssssss
  1027.           XmNentryParent     XmCWidget          Widget          NULL          CSG
  1028.           XmNoutlineState    XmCOutlineState    unsigned char   XmCOLLAPSED   CSG
  1029.           XmNpositionIndex   XmCPositionIndex   int             dynamic       CSG
  1030.  
  1031.           XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt
  1032.                     Specifies the widget that is this item's logical
  1033.                     parent.  A value of NULL indicates that this is a
  1034.                     root-level item. Parent-child information is
  1035.                     displayed only when the _X_m_N_l_a_y_o_u_t_P_o_l_i_c_y is
  1036.                     XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEEor XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.
  1037.  
  1038.           XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee
  1039.                     Specifies whether to display child items when
  1040.                     _X_m_N_l_a_y_o_u_t_P_o_l_i_c_y is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL.  It can
  1041.                     have one of the following values:
  1042.  
  1043.                     XXXXmmmmCCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD
  1044.                               Does not display child items.
  1045.  
  1046.                     XXXXmmmmEEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD
  1047.                               Displays child items.
  1048.  
  1049.           XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                        (printed 10/24/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1061.  
  1062.  
  1063.  
  1064.                     Specifies the order of items in the Container for
  1065.                     display.  When XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or
  1066.                     XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL, items are displayed in XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx
  1067.                     order within XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt.  Items that have an
  1068.                     XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt resource are ignored when
  1069.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL.  If XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx
  1070.                     is not specified, it defaults to the
  1071.                     XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx value plus 1 of the item with the
  1072.                     highest XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx that has the same
  1073.                     XXXXmmmmNNNNeeeennnnttttrrrryyyyPPPPaaaarrrreeeennnntttt if such an item exists; otherwise,
  1074.                     it defaults to 0.
  1075.  
  1076.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  1077.           Container inherits behavior and resources from the
  1078.           superclasses described in the following tables.  For a
  1079.           complete description of each resource, refer to the
  1080.           reference page for that superclass.
  1081.  
  1082.                                                 XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  1083.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  1084.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel               dynamic                CSG
  1085.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  1086.           XmNforeground             XmCForeground           Pixel               dynamic                CSG
  1087.           XmNhelpCallback           XmCCallback             XtCallbackList      NULL                   C
  1088.           XmNhighlightColor         XmCHighlightColor       Pixel               dynamic                CSG
  1089.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap              dynamic                CSG
  1090.           XmNinitialFocus           XmCInitialFocus         Widget              NULL                   CSG
  1091.           XmNlayoutDirection        XmCLayoutDirection      XmDirection         dynamic                CG
  1092.           XmNnavigationType         XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  1093.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList      NULL                   C
  1094.           XmNshadowThickness        XmCShadowThickness      Dimension           0                      CSG
  1095.           XmNstringDirection        XmCStringDirection      XmStringDirection   dynamic                CG
  1096.           XmNtopShadowColor         XmCTopShadowColor       Pixel               dynamic                CSG
  1097.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap              dynamic                CSG
  1098.           XmNtraversalOn            XmCTraversalOn          Boolean             True                   CSG
  1099.           XmNunitType               XmCUnitType             unsigned char       dynamic                CSG
  1100.           XmNuserData               XmCUserData             XtPointer           NULL                   CSG
  1101.  
  1102.                                   CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  1103.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  1104.           XmNchildren         XmCReadOnly         WidgetList    NULL      G
  1105.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  1106.           XmNnumChildren      XmCReadOnly         Cardinal      0         G
  1107.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  1108.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  1109.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  1110.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  1111.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  1112.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  1113.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                        (printed 10/24/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1127.  
  1128.  
  1129.  
  1130.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  1131.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  1132.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  1133.           XmNdepth                        XmCDepth                        int              dynamic                CG
  1134.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  1135.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  1136.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  1137.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  1138.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  1139.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  1140.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  1141.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  1142.           XmNx                            XmCPosition                     Position         0                      CSG
  1143.           XmNy                            XmCPosition                     Position         0                      CSG
  1144.  
  1145.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  1146.           A pointer to the following structure is passed to callbacks
  1147.           for XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.
  1148.  
  1149.           typedef struct
  1150.           {
  1151.                   int _r_e_a_s_o_n;
  1152.                   XEvent * _e_v_e_n_t;
  1153.                   Widget _i_t_e_m;
  1154.                   unsigned char _n_e_w__o_u_t_l_i_n_e__s_t_a_t_e;
  1155.           } XmContainerOutlineCallbackStruct;
  1156.  
  1157.           _r_e_a_s_o_n    Specifies the reason for the callback.
  1158.  
  1159.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  1160.                     It can be NULL.
  1161.  
  1162.           _i_t_e_m      Specifies the container item affected by the
  1163.                     event.
  1164.  
  1165.           _n_e_w__o_u_t_l_i_n_e__s_t_a_t_e
  1166.                     Specifies the next XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee for _i_t_e_m. The
  1167.                     user can change this value in the callback.
  1168.  
  1169.           A pointer to the following structure is passed to callbacks
  1170.           for XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk.
  1171.  
  1172.           typedef struct
  1173.           {
  1174.                   int _r_e_a_s_o_n;
  1175.                   XEvent * _e_v_e_n_t;
  1176.                   WidgetList _s_e_l_e_c_t_e_d__i_t_e_m_s;
  1177.                   int _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t;
  1178.                   unsigned char _a_u_t_o__s_e_l_e_c_t_i_o_n__t_y_p_e;
  1179.           } XmContainerSelectCallbackStruct;
  1180.  
  1181.           _r_e_a_s_o_n    Specifies the reason for the callback. It
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                        (printed 10/24/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1193.  
  1194.  
  1195.  
  1196.                     corresponds to the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy at the time
  1197.                     the selection was made, or indicates that the
  1198.                     default action should be taken.
  1199.  
  1200.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  1201.                     It can be NULL.
  1202.  
  1203.           _s_e_l_e_c_t_e_d__i_t_e_m_s
  1204.                     Specifies a list of items selected at the time of
  1205.                     the _e_v_e_n_t that caused the callback.  The
  1206.                     _s_e_l_e_c_t_e_d__i_t_e_m_s field points to a temporary storage
  1207.                     space that is reused after the callback is
  1208.                     finished.  Therefore, if an application needs to
  1209.                     save the selected list, it should copy the list
  1210.                     into its own data space.
  1211.  
  1212.           _s_e_l_e_c_t_e_d__i_t_e_m__c_o_u_n_t
  1213.                     Specifies the number of items in the
  1214.                     _s_e_l_e_c_t_e_d__i_t_e_m_s list.  This number must be positive
  1215.                     or 0 (zero).
  1216.  
  1217.           aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee
  1218.                     Indicates the cause of the selection when
  1219.                     XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT. Valid
  1220.                     values are the following:
  1221.  
  1222.                     XXXXmmmmAAAAUUUUTTTTOOOO____UUUUNNNNSSSSEEEETTTT
  1223.                               Returned when XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  1224.                               XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT.
  1225.  
  1226.                     XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN
  1227.                               Indicates the beginning of automatic
  1228.                               selection.
  1229.  
  1230.                     XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN
  1231.                               Indicates that there is a button drag
  1232.                               selection.
  1233.  
  1234.                     XXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL
  1235.                               Indicates that the new selection is
  1236.                               canceled.
  1237.  
  1238.                     XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE
  1239.                               Indicates that the currently selected
  1240.                               item matches the initial item.
  1241.  
  1242.                     XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE
  1243.                               Indicates that the currently selected
  1244.                               item does not match the initial item.
  1245.  
  1246.           A pointer to the following structure is passed to the
  1247.           XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures:
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                        (printed 10/24/98)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1259.  
  1260.  
  1261.  
  1262.           typedef struct
  1263.           {
  1264.                   int _r_e_a_s_o_n;
  1265.                   XEvent  *_e_v_e_n_t;
  1266.                   Atom _s_e_l_e_c_t_i_o_n;
  1267.                   Atom _t_a_r_g_e_t;
  1268.                   XtPointer _s_o_u_r_c_e__d_a_t_a;
  1269.                   XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
  1270.                   int _f_l_a_g_s;
  1271.                   XtPointer _p_a_r_m;
  1272.                   int _p_a_r_m__f_o_r_m_a_t;
  1273.                   unsigned long _p_a_r_m__l_e_n_g_t_h;
  1274.                   int _s_t_a_t_u_s;
  1275.                   XtPointer _v_a_l_u_e;
  1276.                   Atom _t_y_p_e;
  1277.                   int _f_o_r_m_a_t;
  1278.                   unsigned long _l_e_n_g_t_h;
  1279.           } XmConvertCallbackStruct;
  1280.  
  1281.           _r_e_a_s_o_n    Indicates why the callback was invoked.
  1282.  
  1283.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  1284.                     It can be NULL.
  1285.  
  1286.           _s_e_l_e_c_t_i_o_n Indicates the selection for which conversion is
  1287.                     being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
  1288.                     _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.
  1289.  
  1290.           _t_a_r_g_e_t    Indicates the conversion target.
  1291.  
  1292.           _s_o_u_r_c_e__d_a_t_a
  1293.                     Contains information about the selection source.
  1294.                     When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, _s_o_u_r_c_e__d_a_t_a is
  1295.                     the DragContext.  Otherwise, it is NULL.
  1296.  
  1297.           llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
  1298.                     Contains information about the location of data to
  1299.                     be converted.  If the value is NULL, the data to
  1300.                     be transferred consists of the widget's current
  1301.                     selection.  Otherwise, it is the widget ID of the
  1302.                     item being transferred, or the widget ID of the
  1303.                     Container if all items are being transferred.
  1304.  
  1305.           _f_l_a_g_s     Indicates the status of the conversion. Following
  1306.                     are the possible values:
  1307.  
  1308.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
  1309.                               This flag is currently unused.
  1310.  
  1311.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____PPPPAAAARRRRTTTTIIIIAAAALLLL
  1312.                               The target widget was able to be
  1313.                               converted, but some data was lost.
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                        (printed 10/24/98)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1325.  
  1326.  
  1327.  
  1328.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
  1329.                               The conversion target is the source of
  1330.                               the data to be transferred.
  1331.  
  1332.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____TTTTRRRRAAAANNNNSSSSAAAACCCCTTTT
  1333.                               This flag is currently unused.
  1334.  
  1335.           _p_a_r_m      Contains parameter data for this target.  If no
  1336.                     parameter data exists, the value is NULL.
  1337.  
  1338.                     When _s_e_l_e_c_t_i_o_n is _C_L_I_P_B_O_A_R_D and _t_a_r_g_e_t is
  1339.                     ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS or
  1340.                     ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS, the value is
  1341.                     the requested operation (XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmMMMMOOOOVVVVEEEE, or
  1342.                     XXXXmmmmLLLLIIIINNNNKKKK).
  1343.  
  1344.           _p_a_r_m__f_o_r_m_a_t
  1345.                     Specifies whether the data in _p_a_r_m should be
  1346.                     viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g
  1347.                     quantities.  Possible values are 0 (when _p_a_r_m is
  1348.                     NULL), 8 (when the data in _p_a_r_m should be viewed
  1349.                     as a list of _c_h_a_rs), 16 (when the data in _p_a_r_m
  1350.                     should be viewed as a list of _s_h_o_r_ts), or 32 (when
  1351.                     the data in _p_a_r_m should be viewed as a list of
  1352.                     _l_o_n_gs).  Note that _p_a_r_m__f_o_r_m_a_t symbolizes a data
  1353.                     type, not the number of bits in each list element.
  1354.                     For example, on some machines, a _p_a_r_m__f_o_r_m_a_t of 32
  1355.                     means that the data in _p_a_r_m should be viewed as a
  1356.                     list of 64-bit quantities, not 32-bit quantities.
  1357.  
  1358.           _p_a_r_m__l_e_n_g_t_h
  1359.                     Specifies the number of elements of data in _p_a_r_m,
  1360.                     where each element has the size specified by
  1361.                     _p_a_r_m__f_o_r_m_a_t.  When _p_a_r_m is NULL, the value is 0.
  1362.  
  1363.           _s_t_a_t_u_s    An IN/OUT member that specifies the status of the
  1364.                     conversion.  The initial value is
  1365.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT.  The callback procedure can set
  1366.                     this member to one of the following values:
  1367.  
  1368.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT
  1369.                               The widget class conversion procedure,
  1370.                               if any, is called after the callback
  1371.                               procedures return.  If the widget class
  1372.                               conversion procedure produces any data,
  1373.                               it overwrites the data provided by the
  1374.                               callback procedures in the _v_a_l_u_emember.
  1375.  
  1376.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE
  1377.                               The widget class conversion procedure,
  1378.                               if any, is called after the callback
  1379.                               procedures return.  If the widget class
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                        (printed 10/24/98)
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1391.  
  1392.  
  1393.  
  1394.                               conversion procedure produces any data,
  1395.                               it appends its data to the data provided
  1396.                               by the callback procedures in the _v_a_l_u_e
  1397.                               member.  This value is intended for use
  1398.                               with targets that result in lists of
  1399.                               data, such as _T_A_R_G_E_T_S.
  1400.  
  1401.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE
  1402.                               The callback procedure has successfully
  1403.                               finished the conversion.  The widget
  1404.                               class conversion procedure, if any, is
  1405.                               not called after the callback procedures
  1406.                               return.
  1407.  
  1408.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE
  1409.                               The callback procedure has terminated
  1410.                               the conversion process without
  1411.                               completing the requested conversion.
  1412.                               The widget class conversion procedure,
  1413.                               if any, is not called after the callback
  1414.                               procedures return.
  1415.  
  1416.           _v_a_l_u_e     An IN/OUT parameter that contains any data that
  1417.                     the callback procedure produces as a result of the
  1418.                     conversion.  The initial value is NULL.  If the
  1419.                     callback procedure sets this member, it must
  1420.                     ensure that the _t_y_p_e, _f_o_r_m_a_t, and _l_e_n_g_t_h members
  1421.                     correspond to the data in _v_a_l_u_e.  The callback
  1422.                     procedure is responsible for allocating, but not
  1423.                     for freeing, memory when it sets this member.
  1424.  
  1425.           _t_y_p_e      An IN/OUT parameter that indicates the type of the
  1426.                     data in the _v_a_l_u_e member.  The initial value is
  1427.                     _I_N_T_E_G_E_R.
  1428.  
  1429.           _f_o_r_m_a_t    An IN/OUT parameter that specifies whether the
  1430.                     data in _v_a_l_u_e should be viewed as a list of _c_h_a_r,
  1431.                     _s_h_o_r_t, or _l_o_n_g quantities.  The initial value is
  1432.                     8.  The callback procedure can set this member to
  1433.                     8 (for a list of _c_h_a_r), 16 (for a list of _s_h_o_r_t),
  1434.                     or 32 (for a list of _l_o_n_g).
  1435.  
  1436.           _l_e_n_g_t_h    An IN/OUT member that specifies the number of
  1437.                     elements of data in _v_a_l_u_e, where each element has
  1438.                     the size symbolized by _f_o_r_m_a_t.  The initial value
  1439.                     is 0 (zero).
  1440.  
  1441.           A pointer to the following callback structure is passed to
  1442.           the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures:
  1443.  
  1444.           typedef struct
  1445.           {
  1446.  
  1447.  
  1448.  
  1449.      Page 22                                        (printed 10/24/98)
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1457.  
  1458.  
  1459.  
  1460.                   int _r_e_a_s_o_n;
  1461.                   XEvent  *_e_v_e_n_t;
  1462.                   Atom _s_e_l_e_c_t_i_o_n;
  1463.                   XtEnum _o_p_e_r_a_t_i_o_n;
  1464.                   int _f_l_a_g_s;
  1465.                   XtPointer _t_r_a_n_s_f_e_r__i_d;
  1466.                   XtPointer _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a;
  1467.                   XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
  1468.                   Time _t_i_m_e;
  1469.           } XmDestinationCallbackStruct;
  1470.  
  1471.           _r_e_a_s_o_n    Indicates why the callback was invoked.
  1472.  
  1473.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  1474.                     It can be NULL.
  1475.  
  1476.           _s_e_l_e_c_t_i_o_n Indicates the selection for which data transfer is
  1477.                     being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
  1478.                     _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.
  1479.  
  1480.           _o_p_e_r_a_t_i_o_n Indicates the type of transfer operation
  1481.                     requested.
  1482.  
  1483.                        +o  When the selection is _P_R_I_M_A_R_Y, possible
  1484.                           values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, and XXXXmmmmLLLLIIIINNNNKKKK.
  1485.  
  1486.                        +o  When the selection is _S_E_C_O_N_D_A_R_Y or
  1487.                           _C_L_I_P_B_O_A_R_D, possible values are XXXXmmmmCCCCOOOOPPPPYYYY and
  1488.                           XXXXmmmmLLLLIIIINNNNKKKK.
  1489.  
  1490.                        +o  When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, possible
  1491.                           values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and
  1492.                           XXXXmmmmOOOOTTTTHHHHEEEERRRR.  A value of XXXXmmmmOOOOTTTTHHHHEEEERRRR means that the
  1493.                           callback procedure must get further
  1494.                           information from the
  1495.                           XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt in the
  1496.                           _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member.
  1497.  
  1498.           _f_l_a_g_s     Indicates whether or not the destination widget is
  1499.                     also the source of the data to be transferred.
  1500.                     Following are the possible values:
  1501.  
  1502.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
  1503.                               The destination widget is not the source
  1504.                               of the data to be transferred.
  1505.  
  1506.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
  1507.                               The destination widget is the source of
  1508.                               the data to be transferred.
  1509.  
  1510.           ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd
  1511.                     Serves as a unique ID to identify the transfer
  1512.  
  1513.  
  1514.  
  1515.      Page 23                                        (printed 10/24/98)
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1523.  
  1524.  
  1525.  
  1526.                     transaction.
  1527.  
  1528.           _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a
  1529.                     Contains information about the destination.  When
  1530.                     the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, the callback
  1531.                     procedures are called by the drop site's
  1532.                     XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc, and _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais a pointer to
  1533.                     the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
  1534.                     XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc procedure.  When the selection is
  1535.                     _S_E_C_O_N_D_A_R_Y, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is an Atom
  1536.                     representing a target recommmended by the
  1537.                     selection owner for use in converting the
  1538.                     selection.  Otherwise, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is NULL.
  1539.  
  1540.           llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
  1541.                     Contains information about the location where data
  1542.                     is to be transferred.  The value is always NULL
  1543.                     when the selection is _S_E_C_O_N_D_A_R_Y or _C_L_I_P_B_O_A_R_D.  If
  1544.                     the value is NULL, the data is to be inserted at
  1545.                     the widget's cursor position.  Otherwise, the
  1546.                     value is a pointer to an _X_P_o_i_n_t structure
  1547.                     containing the x and y coordinates at the location
  1548.                     where the data is to be transferred.  Once
  1549.                     _X_m_T_r_a_n_s_f_e_r_D_o_n_e procedures start to be called,
  1550.                     llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa will no longer be stable.
  1551.  
  1552.           _t_i_m_e      Indicates the time when the transfer operation
  1553.                     began.
  1554.  
  1555.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  1556.           The XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr translations are listed below.
  1557.  
  1558.           The following key names are listed in the X standard key
  1559.           event translation table syntax.  This format is the one used
  1560.           by Motif to specify the widget actions corresponding to a
  1561.           given key.  A brief overview of the format is provided under
  1562.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
  1563.           format, please refer to the X Toolkit Instrinsics
  1564.           Documentation.
  1565.  
  1566.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  1567.                     ContainerBeginSelect()
  1568.  
  1569.           <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>:
  1570.                     ContainerButtonMotion()
  1571.  
  1572.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  1573.                     ContainerEndSelect()
  1574.  
  1575.           cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  1576.                     ContainerBeginToggle()
  1577.  
  1578.  
  1579.  
  1580.  
  1581.      Page 24                                        (printed 10/24/98)
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1589.  
  1590.  
  1591.  
  1592.           cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  1593.                     ContainerEndToggle()
  1594.  
  1595.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  1596.                     ContainerBeginExtend()
  1597.  
  1598.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  1599.                     ContainerEndExtend()
  1600.  
  1601.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  1602.                     ContainerBeginExtend()
  1603.  
  1604.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  1605.                     ContainerEndExtend()
  1606.  
  1607.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  1608.                     ContainerStartTransfer(_C_o_p_y)
  1609.  
  1610.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  1611.                     ContainerStartTransfer(_L_i_n_k)
  1612.  
  1613.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  1614.                     ContainerStartTransfer(_M_o_v_e)
  1615.  
  1616.           ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>:
  1617.                     ContainerEndTransfer()
  1618.  
  1619.           ::::cccc ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
  1620.                     ContainerPrimaryLink()
  1621.  
  1622.           ::::cccc ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
  1623.                     ContainerPrimaryLink()
  1624.  
  1625.           ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
  1626.                     ContainerPrimaryCopy()
  1627.  
  1628.           ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
  1629.                     ContainerPrimaryCopy()
  1630.  
  1631.           ::::ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
  1632.                     ContainerPrimaryMove()
  1633.  
  1634.           ::::ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
  1635.                     ContainerPrimaryMove()
  1636.  
  1637.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
  1638.                     ContainerCancel()
  1639.  
  1640.           ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
  1641.                     ContainerExtend()
  1642.  
  1643.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
  1644.  
  1645.  
  1646.  
  1647.      Page 25                                        (printed 10/24/98)
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1655.  
  1656.  
  1657.  
  1658.                     ContainerSelect()
  1659.  
  1660.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeeccccttttAAAAllllllll>>>>:
  1661.                     ContainerSelectAll()
  1662.  
  1663.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll>>>>:
  1664.                     ContainerDeselectAll()
  1665.  
  1666.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>:
  1667.                     ContainerToggleMode()
  1668.  
  1669.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
  1670.                     ContainerActivate()
  1671.  
  1672.           ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
  1673.                     ContainerExtend()
  1674.  
  1675.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
  1676.                     ContainerSelect()
  1677.  
  1678.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
  1679.                     ContainerActivate()
  1680.  
  1681.           ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh:
  1682.                     ContainerSelectAll()
  1683.  
  1684.           ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh:
  1685.                     ContainerDeselectAll()
  1686.  
  1687.           ::::cccc ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
  1688.                     ContainerExtendCursor(_F_i_r_s_t)
  1689.  
  1690.           ::::cccc ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
  1691.                     ContainerExtendCursor(_L_a_s_t)
  1692.  
  1693.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
  1694.                     ContainerMoveCursor(_F_i_r_s_t)
  1695.  
  1696.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
  1697.                     ContainerMoveCursor(_L_a_s_t)
  1698.  
  1699.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  1700.                     ContainerExpandOrCollapse(_L_e_f_t)
  1701.  
  1702.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  1703.                     ContainerExpandOrCollapse(_R_i_g_h_t)
  1704.  
  1705.           ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  1706.                     ContainerExtendCursor(_U_p)
  1707.  
  1708.           ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  1709.                     ContainerExtendCursor(_D_o_w_n)
  1710.  
  1711.  
  1712.  
  1713.      Page 26                                        (printed 10/24/98)
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1721.  
  1722.  
  1723.  
  1724.           ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  1725.                     ContainerExtendCursor(_L_e_f_t)
  1726.  
  1727.           ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  1728.                     ContainerExtendCursor(_R_i_g_h_t)
  1729.  
  1730.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  1731.                     ContainerMoveCursor(_U_p)
  1732.  
  1733.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  1734.                     ContainerMoveCursor(_D_o_w_n)
  1735.  
  1736.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  1737.                     ContainerMoveCursor(_L_e_f_t)
  1738.  
  1739.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  1740.                     ContainerMoveCursor(_R_i_g_h_t)
  1741.  
  1742.           ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  1743.                     ManagerGadgetPrevTabGroup()
  1744.  
  1745.           ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  1746.                     ManagerGadgetNextTabGroup()
  1747.  
  1748.           The Container button event translations are modified when
  1749.           Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource does not have a
  1750.           value of XXXXmmmmOOOOFFFFFFFF (in other words, it is either
  1751.           _X_m_B_U_T_T_O_N_2__T_R_A_N_S_F_E_R or _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T). This option allows
  1752.           the actions for selection and transfer to be integrated on
  1753.           <<<<BBBBttttnnnn1111>>>>, and the actions for extending the selection can be
  1754.           bound to <<<<BBBBttttnnnn2222>>>>. The actions for <<<<BBBBttttnnnn1111>>>> that are defined in
  1755.           the preceding list still apply when the <<<<BBBBttttnnnn1111>>>> event occurs
  1756.           over text that is not selected. The following actions apply
  1757.           when the <<<<BBBBttttnnnn1111>>>> event occurs over text that is selected:
  1758.  
  1759.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>::::
  1760.                     ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_S_e_l_e_c_t,_C_o_p_y)
  1761.  
  1762.           cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>::::
  1763.                     ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_T_o_g_g_l_e,_C_o_p_y)
  1764.  
  1765.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>::::
  1766.                     ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_N_o_o_p,_L_i_n_k)
  1767.  
  1768.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>::::
  1769.                     ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_E_x_t_e_n_d,_M_o_v_e)
  1770.  
  1771.           <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>::::
  1772.                     ContainerHandleBtn1Motion(_C_o_n_t_a_i_n_e_r_B_u_t_t_o_n_M_o_t_i_o_n)
  1773.  
  1774.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>::::
  1775.                     ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_S_e_l_e_c_t)
  1776.  
  1777.  
  1778.  
  1779.      Page 27                                        (printed 10/24/98)
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1787.  
  1788.  
  1789.  
  1790.           cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>::::
  1791.                     ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_T_o_g_g_l_e)
  1792.  
  1793.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>::::
  1794.                     ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_E_x_t_e_n_d)
  1795.  
  1796.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>::::
  1797.                     ContainerHandleBtn1Down(_C_o_n_t_a_i_n_e_r_B_e_g_i_n_E_x_t_e_n_d)
  1798.  
  1799.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>::::
  1800.                     ContainerHandleBtn1Up(_C_o_n_t_a_i_n_e_r_E_n_d_E_x_t_e_n_d)
  1801.  
  1802.           When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of
  1803.           _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the following actions apply:
  1804.  
  1805.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>::::
  1806.                     ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_C_o_p_y)
  1807.  
  1808.           cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>::::
  1809.                     ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_L_i_n_k)
  1810.  
  1811.           ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>::::
  1812.                     ContainerHandleBtn2Down(_C_o_n_t_a_i_n_e_r_S_t_a_r_t_T_r_a_n_s_f_e_r,_M_o_v_e)
  1813.  
  1814.           <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>::::
  1815.                     ContainerHandleBtn2Motion(_C_o_n_t_a_i_n_e_r_B_u_t_t_o_n_M_o_t_i_o_n)
  1816.  
  1817.           ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>::::
  1818.                     ContainerHandleBtn2Up(_C_o_n_t_a_i_n_e_r_E_n_d_T_r_a_n_s_f_e_r)
  1819.  
  1820.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  1821.           The Container action routines are described below.  The
  1822.           current selections are always shown with the background
  1823.           color specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttCCCCoooolllloooorrrr resource.
  1824.  
  1825.           ContainerActivate():
  1826.                     This action calls XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkwith
  1827.                     reason XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN.
  1828.  
  1829.           ContainerBeginExtend():
  1830.                     Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  1831.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.  Simply
  1832.                     returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL.
  1833.  
  1834.                     Otherwise, this action sets the selection state of
  1835.                     all items between the anchor item and the item
  1836.                     under the pointer to the selection state of the
  1837.                     anchor item.  The location cursor is moved to the
  1838.                     item under the pointer.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn
  1839.                     is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is
  1840.                     called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor
  1841.                     XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on
  1842.  
  1843.  
  1844.  
  1845.      Page 28                                        (printed 10/24/98)
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1853.  
  1854.  
  1855.  
  1856.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, and with
  1857.                     aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeeeXXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  1858.  
  1859.           ContainerBeginSelect():
  1860.                     If this is a second ContainerBeginSelect() action
  1861.                     that has occurred within the time specified by the
  1862.                     display's multiclick time, this action calls
  1863.                     XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with reason
  1864.                     XXXXmmmmCCCCRRRR____DDDDEEEEFFFFAAAAUUUULLLLTTTT____AAAACCCCTTTTIIIIOOOONNNN and returns.
  1865.  
  1866.                     Otherwise, processing depends on the value of
  1867.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyyas follows:
  1868.  
  1869.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1870.                               This action deselects all items and
  1871.                               toggles the item (if any) under the
  1872.                               pointer.
  1873.  
  1874.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1875.                               This action deselects all items and
  1876.                               toggles the item (if any) under the
  1877.                               pointer.  This item is now the anchor
  1878.                               item for further selection.  If
  1879.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  1880.                               and a change in any item's selection
  1881.                               state is made, the
  1882.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  1883.                               reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and
  1884.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.
  1885.  
  1886.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1887.                               If the pointer is over an item and
  1888.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is not XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE,
  1889.                               this action toggles the selection state
  1890.                               of that item.  The item becomes the
  1891.                               anchor item for further selection.  If
  1892.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE,
  1893.                               XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT, or
  1894.                               XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH, this action sets
  1895.                               the start point for the Marquee
  1896.                               rectangle.  If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is
  1897.                               XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT or
  1898.                               XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is
  1899.                               over an item, this action draws the
  1900.                               Marquee rectangle around the item.  If
  1901.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT,
  1902.                               the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called
  1903.                               with reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and
  1904.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.
  1905.  
  1906.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  1907.                               All items are first deselected.
  1908.  
  1909.  
  1910.  
  1911.      Page 29                                        (printed 10/24/98)
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1919.  
  1920.  
  1921.  
  1922.                               Processing is then identical to the case
  1923.                               where XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  1924.                               XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, except that
  1925.                               XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT is the callback
  1926.                               reason given if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is
  1927.                               called.
  1928.  
  1929.           ContainerBeginToggle():
  1930.                     Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  1931.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.
  1932.  
  1933.                     Otherwise, if the pointer is over an item and
  1934.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is not XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE, this
  1935.                     action toggles the selection state of that item.
  1936.                     The item becomes the anchor item for further
  1937.                     selection.  If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE,
  1938.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT, or
  1939.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHHthis action sets the start
  1940.                     point for the Marquee rectangle.  If
  1941.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____SSSSTTTTAAAARRRRTTTT or
  1942.                     XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is over an
  1943.                     item, this action draws the Marquee rectangle
  1944.                     around the item.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  1945.                     XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is
  1946.                     called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor
  1947.                     XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason, depending on
  1948.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, and with aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee
  1949.                     XXXXmmmmAAAAUUUUTTTTOOOO____BBBBEEEEGGGGIIIINNNN.
  1950.  
  1951.           ContainerButtonMotion():
  1952.                     Processing depends on the value of
  1953.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows:
  1954.  
  1955.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1956.                               This action simply returns to the
  1957.                               caller.
  1958.  
  1959.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1960.                               Simply returns if this action follows a
  1961.                               ContainerBeginExtend()action or
  1962.                               ContainerBeginToggle() action.
  1963.  
  1964.                               If the pointer is no longer over the
  1965.                               current anchor item, this action toggles
  1966.                               the current anchor item and then toggles
  1967.                               the item under the pointer (if any) and
  1968.                               makes it the new anchor item for further
  1969.                               processing.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  1970.                               XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's
  1971.                               selection state is made, the
  1972.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  1973.                               reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT and
  1974.  
  1975.  
  1976.  
  1977.      Page 30                                        (printed 10/24/98)
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  1985.  
  1986.  
  1987.  
  1988.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN.
  1989.  
  1990.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  1991.                               If a previous action has set a Marquee
  1992.                               rectangle start point, this action draws
  1993.                               the Marquee rectangle between the
  1994.                               current pointer position and the Marquee
  1995.                               start point. If the
  1996.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeecccchhhhnnnniiiiqqqquuuueeee is
  1997.                               XXXXmmmmMMMMAAAARRRRQQQQUUUUEEEEEEEE____EEEEXXXXTTTTEEEENNNNDDDD____BBBBOOOOTTTTHHHH and the pointer is
  1998.                               over an item, the end point of the
  1999.                               Marquee rectangle is extended to include
  2000.                               the item. The selection states of all
  2001.                               items within the Marquee rectangle are
  2002.                               toggled to match the state of the anchor
  2003.                               item.
  2004.  
  2005.                               If no Marquee rectangle start point is
  2006.                               set and the pointer is over an item,
  2007.                               processing depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee
  2008.                               resource.  The anchor item from the
  2009.                               previous action is used. If
  2010.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, the
  2011.                               selection state of the item under the
  2012.                               pointer is toggled to match the
  2013.                               selection state of the anchor item.  If
  2014.                               XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmOOOOUUUUTTTTLLLLIIIINNNNEEEE or XXXXmmmmDDDDEEEETTTTAAAAIIIILLLL,
  2015.                               the selection state of all items between
  2016.                               the anchor item and the item under the
  2017.                               pointer are toggled to match the
  2018.                               selection state of the anchor item.
  2019.  
  2020.                               If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2021.                               XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and a change in any item's
  2022.                               selection state is made, the
  2023.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2024.                               reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTand
  2025.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____MMMMOOOOTTTTIIIIOOOONNNN.
  2026.  
  2027.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  2028.                               Processing is identical to the case
  2029.                               where XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  2030.                               XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, except that
  2031.                               XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT is the callback
  2032.                               reason given if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is
  2033.                               called.
  2034.  
  2035.           ContainerCancel():
  2036.                     If a selection is in progress, this action
  2037.                     restores selection states of all items to their
  2038.                     state before the selection began.  If
  2039.                     XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is True and a change in any
  2040.  
  2041.  
  2042.  
  2043.      Page 31                                        (printed 10/24/98)
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2051.  
  2052.  
  2053.  
  2054.                     item's selection state is made, the
  2055.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason
  2056.                     XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, or
  2057.                     XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTTdepending on the
  2058.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy resource and
  2059.                     aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeeeXXXXmmmmAAAAUUUUTTTTOOOO____CCCCAAAANNNNCCCCEEEELLLL.
  2060.  
  2061.           ContainerDeselectAll():
  2062.                     This action deselects all items and calls
  2063.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with reason depending on
  2064.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  2065.  
  2066.           ContainerEndExtend():
  2067.                     Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  2068.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.  Simply
  2069.                     returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL.
  2070.  
  2071.                     Otherwise, if XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2072.                     XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is
  2073.                     called with either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor
  2074.                     XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the reason depending on
  2075.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.  If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2076.                     XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and no change is made in any item's
  2077.                     selection state by this action,
  2078.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with either
  2079.                     XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT as the
  2080.                     reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy and
  2081.                     aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  If
  2082.                     XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and this
  2083.                     action makes no change in any item's selection
  2084.                     state, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2085.                     either XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  2086.                     as the reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy and
  2087.                     aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  2088.  
  2089.           ContainerEndSelect():
  2090.                     Processing depends on the value of
  2091.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows:
  2092.  
  2093.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  2094.                               This action calls
  2095.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkwith reason
  2096.                               XXXXmmmmCCCCRRRR____SSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT.
  2097.  
  2098.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  2099.                               If the pointer is no longer over the
  2100.                               current anchor item, this action toggles
  2101.                               the current anchor item and then toggles
  2102.                               the item under the pointer (if any). If
  2103.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2104.                               XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the
  2105.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2106.  
  2107.  
  2108.  
  2109.      Page 32                                        (printed 10/24/98)
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2117.  
  2118.  
  2119.  
  2120.                               reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.  If
  2121.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  2122.                               and a change in any item's selection
  2123.                               state is made, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s)
  2124.                               is called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  2125.                               and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  2126.                               If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2127.                               XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT and no change is made in
  2128.                               any item's selection state by this
  2129.                               action, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is
  2130.                               called with reason XXXXmmmmCCCCRRRR____BBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT
  2131.                               and aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee
  2132.                               XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  2133.  
  2134.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT
  2135.                               This action first performs the same
  2136.                               processing as the
  2137.                               ContainerButtonMotion()action, except
  2138.                               that XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is not called.
  2139.                               If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2140.                               XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the
  2141.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2142.                               reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT.  If
  2143.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  2144.                               and a change in any item's selection
  2145.                               state is made, the
  2146.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2147.                               reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and
  2148.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  If
  2149.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  2150.                               and this action makes no change in any
  2151.                               item's selection state,
  2152.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2153.                               reason XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT and
  2154.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  2155.  
  2156.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  2157.                               This action first performs the same
  2158.                               processing as the
  2159.                               ContainerButtonMotion()action, except
  2160.                               that XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is not called.
  2161.                               If XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is
  2162.                               XXXXmmmmNNNNOOOO____AAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT, the
  2163.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2164.                               reason XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT.  If
  2165.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  2166.                               and a change in any item's selection
  2167.                               state is made, XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s)
  2168.                               is called with reason
  2169.                               XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
  2170.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____CCCCHHHHAAAANNNNGGGGEEEE.  If
  2171.                               XXXXmmmmNNNNaaaauuuuttttoooommmmaaaattttiiiiccccSSSSeeeelllleeeeccccttttiiiioooonnnn is XXXXmmmmAAAAUUUUTTTTOOOO____SSSSEEEELLLLEEEECCCCTTTT
  2172.  
  2173.  
  2174.  
  2175.      Page 33                                        (printed 10/24/98)
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2183.  
  2184.  
  2185.  
  2186.                               and this action makes no change in any
  2187.                               item's selection state,
  2188.                               XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk(s) is called with
  2189.                               reason XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
  2190.                               aaaauuuuttttoooo____sssseeeelllleeeeccccttttiiiioooonnnn____ttttyyyyppppeeee XXXXmmmmAAAAUUUUTTTTOOOO____NNNNOOOO____CCCCHHHHAAAANNNNGGGGEEEE.
  2191.  
  2192.           ContainerEndToggle():
  2193.                     Simply returns if XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is
  2194.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT.  If
  2195.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
  2196.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action performs the same
  2197.                     processing as the ContainerEndSelect() action.
  2198.  
  2199.           ContainerEndTransfer()::
  2200.                     If the elapsed time since a
  2201.                     ContainerStartTransfer()action has occurred
  2202.                     exceeds the time span specified by the display's
  2203.                     multiclick time, this action returns.
  2204.  
  2205.                     Otherwise, the ContainerPrimaryCopy(),
  2206.                     ContainerPrimaryLink(), or ContainerPrimaryMove()
  2207.                     action is invoked, depending on the value of the
  2208.                     operation parameter saved by
  2209.                     ContainerStartTransfer().
  2210.  
  2211.           ContainerExpandOrCollapse(_L_e_f_t|_R_i_g_h_t|_C_o_l_l_a_p_s_e|_E_x_p_a_n_d):
  2212.                     This action changes the value of the
  2213.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee of the current focus widget. If
  2214.                     the argument value is CCCCoooollllllllaaaappppsssseeee or LLLLeeeefffftttt, the
  2215.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee resource value is set to
  2216.                     XXXXmmmmCCCCOOOOLLLLLLLLAAAAPPPPSSSSEEEEDDDD. If the argument value is EEEExxxxppppaaaannnnddddor
  2217.                     RRRRiiiigggghhhhtttt, the XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee resource value is set
  2218.                     to XXXXmmmmEEEEXXXXPPPPAAAANNNNDDDDEEEEDDDD.
  2219.  
  2220.                     If the argument is LLLLeeeefffftttt or RRRRiiiigggghhhhtttt and the layout is
  2221.                     right to left, then the setting of the
  2222.                     XXXXmmmmNNNNoooouuuuttttlllliiiinnnneeeeSSSSttttaaaatttteeee value is reversed from that
  2223.                     described in the preceding paragraph.
  2224.  
  2225.                     Simply returns if XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL.
  2226.  
  2227.           ContainerExtend():
  2228.                     Processing depends on the value of
  2229.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows:
  2230.  
  2231.                     If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
  2232.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action returns.  If
  2233.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action returns.
  2234.  
  2235.                     If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this
  2236.                     action sets the selection state of all items
  2237.                     between the anchor item and the location cursor to
  2238.  
  2239.  
  2240.  
  2241.      Page 34                                        (printed 10/24/98)
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2249.  
  2250.  
  2251.  
  2252.                     the selection state of the anchor item.
  2253.  
  2254.                     If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
  2255.                     the Container is in Normal Mode, this action
  2256.                     deselects all items and selects all items between
  2257.                     the anchor item and the location cursor.  If the
  2258.                     selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the
  2259.                     Container is in Add Mode, this action sets the
  2260.                     selection state of all items between the anchor
  2261.                     item and the location cursor to the selection
  2262.                     state of the anchor item.
  2263.  
  2264.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason
  2265.                     XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  2266.                     depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  2267.  
  2268.           ContainerExtendCursor(_L_e_f_t|_R_i_g_h_t|_U_p|_D_o_w_n):
  2269.                     Processing depends on the value of
  2270.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows:
  2271.  
  2272.                     If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
  2273.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action returns.  If
  2274.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeee is XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action returns.
  2275.  
  2276.                     This action moves the location cursor one item in
  2277.                     the indicated direction, if possible.  If the
  2278.                     value of the argument string is FFFFiiiirrrrsssstttt or LLLLaaaasssstttt,
  2279.                     this action moves the location cursor to the
  2280.                     indicated item. For other values of the argument
  2281.                     string, the location cursor is not affected.
  2282.  
  2283.                     If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this
  2284.                     action sets the selection state of all items
  2285.                     between the anchor item and the location cursor to
  2286.                     the selection state of the anchor item.
  2287.  
  2288.                     If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
  2289.                     the Container is in Normal Mode, this action
  2290.                     deselects all items and selects all items between
  2291.                     the anchor item and the location cursor.  If the
  2292.                     selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the
  2293.                     Container is in Add Mode, this action sets the
  2294.                     selection state of all items between the anchor
  2295.                     item and the location cursor to the selection
  2296.                     state of the anchor item.
  2297.  
  2298.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with reason
  2299.                     XXXXmmmmCCCCRRRR____MMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor XXXXmmmmCCCCRRRR____EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT
  2300.                     depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  2301.  
  2302.           ContainerHandleBtn1Down(_s_t_r_i_n_g))))
  2303.                     When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is
  2304.  
  2305.  
  2306.  
  2307.      Page 35                                        (printed 10/24/98)
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2315.  
  2316.  
  2317.  
  2318.                     not XXXXmmmmOOOOFFFFFFFF, the actions for selection and transfer
  2319.                     are integrated on <<<<BBBBttttnnnn1111>>>>.  If the pointer is over
  2320.                     an unselected item or background, the item is
  2321.                     first selected before the transfer is started.
  2322.                     Otherwise, if the item is already selected, the
  2323.                     transfer is started.  The value of _s_t_r_i_n_g can be
  2324.                     one of the following actions:
  2325.  
  2326.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnSSSSeeeelllleeeecccctttt,,,,CCCCooooppppyyyy
  2327.  
  2328.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnTTTToooogggggggglllleeee,,,,CCCCooooppppyyyy
  2329.  
  2330.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrNNNNoooooooopppp,,,,LLLLiiiinnnnkkkk
  2331.  
  2332.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBeeeeggggiiiinnnnEEEExxxxtttteeeennnndddd,,,,MMMMoooovvvveeee
  2333.  
  2334.           ContainerHandleBtn1Motion(_s_t_r_i_n_g))))
  2335.                     When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is
  2336.                     not XXXXmmmmOOOOFFFFFFFF, the actions for selection and transfer
  2337.                     are integrated on <<<<BBBBttttnnnn1111>>>>. When this action is
  2338.                     invoked, and a selection is in progress, a drag is
  2339.                     performed. Otherwise, the default action as
  2340.                     specified in _s_t_r_i_n_g is performed. The value of
  2341.                     _s_t_r_i_n_gcan be CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn.
  2342.  
  2343.           ContainerHandleBtn1Up(_s_t_r_i_n_g))))
  2344.                     If a Button 1 transfer was in progress, then when
  2345.                     this action is invoked, that transfer is
  2346.                     cancelled. Otherwise, the default action as
  2347.                     specified in _s_t_r_i_n_g is performed. The value of
  2348.                     _s_t_r_i_n_gcan be one of the following actions:
  2349.  
  2350.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddSSSSeeeelllleeeecccctttt
  2351.  
  2352.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddTTTToooogggggggglllleeee
  2353.  
  2354.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddEEEExxxxtttteeeennnndddd
  2355.  
  2356.           ContainerHandleBtn2Down(_s_t_r_i_n_g))))
  2357.                     When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has
  2358.                     a value of _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, the actions for
  2359.                     extending selection are bound on <<<<BBBBttttnnnn2222>>>>.
  2360.                     Otherwise, the action that is performed depends on
  2361.                     the value of _s_t_r_i_n_g, which can be one of the
  2362.                     following actions:
  2363.  
  2364.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,CCCCooooppppyyyy
  2365.  
  2366.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,LLLLiiiinnnnkkkk
  2367.  
  2368.                        +o  CCCCoooonnnnttttaaaaiiiinnnneeeerrrrSSSSttttaaaarrrrttttTTTTrrrraaaannnnssssffffeeeerrrr,,,,MMMMoooovvvveeee
  2369.  
  2370.  
  2371.  
  2372.  
  2373.      Page 36                                        (printed 10/24/98)
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2381.  
  2382.  
  2383.  
  2384.           ContainerHandleBtn2Motion(_s_t_r_i_n_g))))
  2385.                     When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource is
  2386.                     not _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, and a selection is in
  2387.                     progress, a drag is performed.  Otherwise, the
  2388.                     default action that is performed depends on the
  2389.                     value of _s_t_r_i_n_g, which can be
  2390.                     CCCCoooonnnnttttaaaaiiiinnnneeeerrrrBBBBuuuuttttttttoooonnnnMMMMoooottttiiiioooonnnn.
  2391.  
  2392.           ContainerHandleBtn2Up(_s_t_r_i_n_g))))
  2393.                     When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has
  2394.                     a value of _X_m_B_U_T_T_O_N_2__A_D_J_U_S_T, this action ends an
  2395.                     extend. Otherwise, the action that is performed
  2396.                     depends on the value of _s_t_r_i_n_g, which can be
  2397.                     CCCCoooonnnnttttaaaaiiiinnnneeeerrrrEEEEnnnnddddTTTTrrrraaaannnnssssffffeeeerrrr.
  2398.  
  2399.           ContainerMoveCursor(_L_e_f_t|_R_i_g_h_t|_U_p|_D_o_w_n|_F_i_r_s_t|_L_a_s_t):
  2400.                     If the argument is LLLLeeeefffftttt, RRRRiiiigggghhhhtttt, UUUUpppp, or DDDDoooowwwwnnnn, this
  2401.                     action moves the location cursor one item in the
  2402.                     indicated direction, if possible.  If the value of
  2403.                     the argument string is FFFFiiiirrrrsssstttt or LLLLaaaasssstttt, this action
  2404.                     moves the location cursor to the indicated item.
  2405.                     Any other arguments are ignored.
  2406.  
  2407.                     If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, or if
  2408.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the
  2409.                     Container is in Normal Mode, this action deselects
  2410.                     all items, selects the item at the location
  2411.                     cursor, and calls XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk with the
  2412.                     reason depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  2413.  
  2414.           ContainerPrimaryCopy():
  2415.                     This action requests that primary selection data
  2416.                     be copied to the Container.  This action calls the
  2417.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
  2418.                     selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  By default,
  2419.                     the Container does not do any transfer, and
  2420.                     copying the selection is the responsibility of the
  2421.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures.
  2422.  
  2423.           ContainerPrimaryLink():
  2424.                     This action requests that primary selection data
  2425.                     be linked to the Container.  This action calls the
  2426.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
  2427.                     selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.  By default,
  2428.                     the Container does not do any transfer, and
  2429.                     linking the selection is the responsibility of the
  2430.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures.
  2431.  
  2432.           ContainerPrimaryMove():
  2433.                     This action requests that primary selection data
  2434.                     be copied to the Container and deleted from the
  2435.                     primary source.  This action calls the
  2436.  
  2437.  
  2438.  
  2439.      Page 37                                        (printed 10/24/98)
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2447.  
  2448.  
  2449.  
  2450.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
  2451.                     selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  By default,
  2452.                     the Container does not do any transfer, and moving
  2453.                     the selection is the responsibility of the
  2454.                     XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures.  If the transfer
  2455.                     is successful, this action then calls the
  2456.                     selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures
  2457.                     for the _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target.
  2458.  
  2459.           ContainerSelect():
  2460.                     Processing depends on the value of
  2461.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy, as follows:
  2462.  
  2463.                     If the selection policy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
  2464.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action deselects all items
  2465.                     and selects the item at the location cursor.
  2466.  
  2467.                     If the selection policy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT, this
  2468.                     action toggles the selection state of the item at
  2469.                     the location cursor.  This item becomes the anchor
  2470.                     item for further selections.
  2471.  
  2472.                     If the selection policy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and
  2473.                     the Container is in Normal Mode, this action
  2474.                     deselects all items and selects the item at the
  2475.                     location cursor. If the selection policy is
  2476.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT and the Container is in Add
  2477.                     Mode, this action toggles the selection state of
  2478.                     the item at the location cursor.  The
  2479.                     selected/toggled item becomes the anchor item for
  2480.                     further selections.
  2481.  
  2482.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with the reason
  2483.                     depending on XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy.
  2484.  
  2485.           ContainerSelectAll():
  2486.                     If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTT or
  2487.                     XXXXmmmmBBBBRRRROOOOWWWWSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTT, this action deselects all items
  2488.                     and selects the item at the location cursor
  2489.                     position.
  2490.  
  2491.                     If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmMMMMUUUULLLLTTTTIIIIPPPPLLLLEEEE____SSSSEEEELLLLEEEECCCCTTTTor
  2492.                     XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this action selects all items.
  2493.  
  2494.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk is called with the reason
  2495.                     depending on the value of XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk.
  2496.  
  2497.           ContainerStartTransfer(_C_o_p_y|_M_o_v_e|_L_i_n_k):
  2498.                     This action saves the event and the operation
  2499.                     specified in the argument string for use by
  2500.                     subsequent actions.  If no ContainerEndTransfer()
  2501.                     actions occur within the time span specified by
  2502.  
  2503.  
  2504.  
  2505.      Page 38                                        (printed 10/24/98)
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.      XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr((((3333XXXX))))
  2513.  
  2514.  
  2515.  
  2516.                     the display's multiclick time and if
  2517.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttTTTTyyyyppppeeeeis XXXXmmmmSSSSPPPPAAAATTTTIIIIAAAALLLL, this action creates a
  2518.                     DragContext and starts a drag transfer by using
  2519.                     _s_t_r_i_n_g to specify the transfer operation. If no
  2520.                     argument string is specified, CCCCooooppppyyyy is the default
  2521.                     value.
  2522.  
  2523.                     Unless default drag and drop behavior has been
  2524.                     overridden by a XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure, if
  2525.                     the drop operation occurs within the Container,
  2526.                     then the item(s) being dragged are relocated at
  2527.                     the position of the drop operation. If the item
  2528.                     targeted by the Drag operation is not in the
  2529.                     selected state, then only that item is moved. If
  2530.                     the item is in the selected state, however, all
  2531.                     items in the selected state are moved.
  2532.  
  2533.           ContainerToggleMode():
  2534.                     If XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnPPPPoooolllliiiiccccyyyy is XXXXmmmmEEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD____SSSSEEEELLLLEEEECCCCTTTT, this
  2535.                     action toggles the Container between Normal Mode
  2536.                     and Add Mode.
  2537.  
  2538.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  2539.           The Container widget has the following additional behavior:
  2540.  
  2541.           <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>((((2222++++))))
  2542.                     If a button click is followed by another button
  2543.                     click within the time span specified by the
  2544.                     display's multiclick time, the Container
  2545.                     interprets that as a double-click and calls the
  2546.                     XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  2547.  
  2548.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  2549.                     If the focus policy is explicit, sets the focus
  2550.                     and draws the location cursor.
  2551.  
  2552.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  2553.                     If the focus policy is explicit, removes the focus
  2554.                     and erases the location cursor.
  2555.  
  2556.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  2557.           The bindings for virtual keys are vendor specific.  For
  2558.           information about bindings for virtual buttons and keys, see
  2559.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  2560.  
  2561.      RRRREEEELLLLAAAATTTTEEEEDDDD
  2562.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCooooppppyyyy,
  2563.           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCooooppppyyyyLLLLiiiinnnnkkkk, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrCCCCuuuutttt,
  2564.           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrGGGGeeeettttIIIItttteeeemmmmCCCChhhhiiiillllddddrrrreeeennnn, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrPPPPaaaasssstttteeee,
  2565.           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrPPPPaaaasssstttteeeeLLLLiiiinnnnkkkk, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrRRRReeeellllaaaayyyyoooouuuutttt(3),
  2566.           XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrRRRReeeeoooorrrrddddeeeerrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeCCCCoooonnnnttttaaaaiiiinnnneeeerrrr(3),
  2567.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3), XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3), and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3).
  2568.  
  2569.  
  2570.  
  2571.      Page 39                                        (printed 10/24/98)
  2572.  
  2573.  
  2574.  
  2575.